home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 422_02 / dosutil / tfb.doc < prev    next >
Text File  |  1994-03-20  |  4KB  |  94 lines
  1. TFB: A Tsr File Browser
  2.  
  3.    This is a small file viewing utility, that can be installed as a TSR,
  4. allowing you to view files from within most other DOS applications. Its
  5. main features are:
  6.  
  7.  - Small! (< 10K .COM file)
  8.  - Can be installed as TSR, or run as standard DOS command.
  9.  - View files up to 65535 lines (no other size limit).
  10.  - You can have up to 10 "place markers" per file.
  11.  - Remembers where you are in up to 10 separate files, allowing you to
  12.    pop up and down, and switch between them without losing your place.
  13.    Position, Place markers, Tab size, Search string etc. are stored and
  14.    recalled when you select another file from the "pick list".
  15.  
  16. TFB command syntax:
  17.  
  18.    TFB [/ACLRS] [filename]
  19.  
  20.    [/ACLRS] = Hotkeys for TSR operation.
  21.      A=Alt, C=Ctrl, L=LeftShift, R=RightShift, S=SysReq*
  22.          *=SysReq may not work on some systems
  23.      If no hotkeys are specified, TFB runs as a normal DOS command.
  24.  
  25.    [filename] = Initial file to browse
  26.      If not given, TFB will prompt for the file (in TSR operation,
  27.      this prompt will occur the first time you "pop-up").
  28.  
  29. While inside the TFB main display screen, you can use the following keys:
  30.  
  31.    Up       - Backup display on line.
  32.    Down     - Advance display one line.
  33.    Left     - Shift display one column to the Left.
  34.    Right    - Shift display one column to the right.
  35.    PgUp     - Backup display one screen (23 lines).
  36.    PgDn     - Advance display one screen (23 lines).
  37.    Home     - Shift display 20 columns to the left.
  38.    End      - Shift display 20 columns to the right.
  39.    CTL-Home - Position display to column one.
  40.    CTL-PgUp - Position display to beginning of file.
  41.    CTL-PgDn - Position display to end of file.
  42.    F1       - Display Function Key summary.
  43.    F2       - Prompt for line# and go to line.
  44.    F3       - Prompt for string and search (from current line).
  45.    F4       - Repeat last search (from current line + 1).
  46.    F5       - Position to tagged line number.
  47.    F6       - Set a tag at current line number.
  48.    F7       - Prompt for new TAB spacing.
  49.    F8       - Change screen colors.
  50.    F9       - Open another file.
  51.    F10      - "Pick" list of last 10 files opened.
  52.    ESC      - Exit TFB
  53.  
  54. Misc Notes:
  55.  
  56.  - Most functions may be aborted by the ESCAPE key.
  57.  
  58.  - TFB re-opens the file every time you "pop-up" or "pick" a new file.
  59.    This allows it to not have any files open when it is inactive. If you
  60.    plan to "cd" to another directory, you should specify the entire
  61.    pathname for any files that you open. If TFB pops up and cannot find
  62.    the file you were last viewing, you will be prompted to enter a new one.
  63.  
  64.  - If you modify a file that you are viewing, you should re-select it from
  65.    the "pick list", so that TFB will re-index it, and insure that the line
  66.    numbers are correct.
  67.  
  68.  - In order that you may pop up and down quickly, TFB does not prompt for
  69.    confirmation before exiting. If you are running it as a TSR, simply
  70.    press your hotkeys again, and you will be right back where you were
  71.    before pressing ESC.
  72.  
  73. TFB makes it easy to view our online .DOV files while working in your
  74. favorite editor (or other environment). It is also particularly useful
  75. with our DDS development kits, for referencing source files from within
  76. monitors or other debuggers. For example, to compile an 8051 'C' program
  77. (in small model), and view a complete assembly language listing with 'C'
  78. source code as comments, and showing memory addresses, you could use:
  79.  
  80.           CC51 myprog m=s -cx      /* Generate complete ASM output */
  81.           ASM51 myprog -f          /* Assemble and generate full listings */
  82.           TFB/RL myprog.lst        /* Load TFB with listing file */
  83.           ... Download "myprog.hex" to target, and debug program ...
  84.           ... Press SHIFT-SHIFT to view listing / 'C' source ...
  85.           ... Use "pick" list to view include, library etc. ...
  86.           ... Press ESCAPE to return to debugger ...
  87.  
  88.  
  89. Dave Dunfield
  90. Dunfield Development Systems
  91. P.O. Box 31044
  92. Nepean, Ontario Canada
  93. K2B 8S8
  94.